home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / util / time / clockdaemon.readme < prev    next >
Text File  |  1997-05-03  |  5KB  |  169 lines
  1. Short:    V1.8: hardware clock at GMT util with SAS/C link lib
  2. Author:   pueschel@imsdd.meb.uni-bonn.de
  3. Uploader: pueschel@imsdd.meb.uni-bonn.de
  4. Type:     util/time
  5.  
  6. ClockDaemon 1.8
  7.  
  8.  
  9. Features:
  10. ---------
  11.  
  12.  - Keeps your hardware clock at GMT (for NetBSD users).
  13.  - Patches battclock.resource so that reads and writes to the hardware
  14.    clock are transparently adjusted.
  15.  - Handles daylight savings time.
  16.  - Does not need ixemul.library.
  17.  - Sets IXGMTOFFSET and internal time for ixemul.library V 42+.
  18.  - Detects DST start & end while computer is running.
  19.  - Optionally runs command when DST begins or ends.
  20.  - DSTCheck program for use in scripts.
  21.  - link library for SAS/C to replace broken time functions
  22.  - NEW: optionally patch locale.library to give correct offset during DST
  23.  
  24. Installation:
  25. -------------
  26.  
  27. Copy ClockDaemon and DSTCheck to C:, and add 
  28.  
  29. run >NIL: ClockDaemon <command> (LOCALEPATCH)
  30.  
  31. to your User-Startup, where <command> is a program you want to be executed when
  32. daylight savings time begins or ends. Store an appropriate (see timezone.doc)
  33. timezone string in ENVARC:TZ.
  34.  
  35. The switch LOCALEPATCH will make ClockDaemon patch the OpenLocale()
  36. function in locale.library. When OpenLocale() is called with a NULL
  37. argument to get the default locale setting, the field loc_GMTOffset will
  38. be set to the correct value. Caution: Some clever programs make a DST
  39. correction of their own. This will blow up now, so you have to disable
  40. that.
  41.  
  42. ClockDaemon will set the IXGMTOFFSET variable and update the internal offset
  43. for ixemul.library V 42 or higher. Do not use ixtimezone !
  44.  
  45. Reboot and reset your clock to your local time via the Time preferences
  46. program.
  47.  
  48. Since version 1.2, ClockDaemon notices the start or end of daylight savings
  49. time regardless if your computer is running at that time or not. (If it is not
  50. running, the change command will be executed the next time ClockDaemon is
  51. started.)
  52.  
  53. ATTENTION: The command you want to have executed must terminate or ClockDaemon
  54.            will hang !
  55.  
  56. Example (for Germany):
  57. ----------------------
  58.  
  59. User-Startup:
  60.  
  61. run >NIL: ClockDaemon SetUMSRFCDST
  62.  
  63.  
  64. ENVARC:TZ:
  65.  
  66. MET-1MEST,M3.5.0,M10.5.0/03
  67.  
  68.  
  69. DSTCheck:
  70. ---------
  71.  
  72. The DSTCheck command gives you an easy way to check the DST status in CLI
  73. scripts. Its return status is WARN (5) during DST, OK (0) otherwise.
  74.  
  75. Example:
  76.  
  77. DSTCheck
  78.  
  79. If Warn
  80.   Echo "We have DST !"
  81. Else
  82.   Echo "We don't have DST !"
  83. Endif
  84.  
  85. time.lib:
  86. ---------
  87.  
  88. The original SAS/C functions gmtime, localtime, mktime and time do not
  89. work correctly. The supplied link library time.lib contains replacement
  90. functions for them. To use them, you can either copy time.lib to lib: and
  91. specify it explicitly when linking your programs, or replace the original
  92. modules in sc.lib. The script patch_sc.lib does this for you.
  93.  
  94. Programs linked with time.lib work with or without ClockDaemon installed.
  95. You are free to distribute or sell your programs containing time.lib.
  96. I only require you to add timezone.doc to such a distribution.
  97.  
  98. Legal Stuff:
  99. ------------
  100.  
  101. There is no warranty. ClockDaemon is Freeware.
  102.  
  103. Credits:
  104. --------
  105.  
  106. I borrowed the timezone string description from the RdateTZ package.
  107. A big "thank you" to the author.
  108.  
  109. The idea to run a script at DST start/end came from Henning Hucke.
  110.  
  111. Thanks to Hans Verkuil for tips on how ixtimezone works, and for
  112. maintaining ixemul.library.
  113.  
  114. Thanks to John Blyth for his feedback, which lead to the addition
  115. of LOCALEPATCH.
  116.  
  117. And finally, a big "Thank You !" to Steve, Doug and Jim at SAS.
  118.  
  119. History:
  120. --------
  121.  
  122. Version 1.0: Not released.
  123.  
  124.         1.1: Added ixemul V 42 support.
  125.  
  126.         1.2: Added DSTCHANGECOMMAND.
  127.              Added detection of DST start/end while computer is on.
  128.              Added DSTCheck command.
  129.  
  130.         1.3: Restructured the code, fixed some minor bugs.
  131.              Added link library for SAS/C.
  132.  
  133.         1.4: Added setting of internal offset if ixemul.library is
  134.              already loaded. Fixed documentation bug; the TZ
  135.              string for Germany changed in 1996.
  136.  
  137.         1.5: Added LOCALEPATCH.
  138.  
  139.         1.6: The LOCALEPATCH mechanism was unnecessarily complicated,
  140.              as apparently locale.library is never unloaded. Removed
  141.              unnecessary patch of OpenLibrary.
  142.  
  143.         1.7: Recompiled with SAS/C 6.57.
  144.              Fixed a bug with julian dates.
  145.              Enhanced time.lib to work better when ClockDaemon is not
  146.              installed.
  147.  
  148.     1.8: Fixed small bug in time.lib and ClockDaemon. Thanks to
  149.              Walter Haidinger for finding the bug.
  150.  
  151. Bug reports & suggestions:
  152. --------------------------
  153.  
  154. Send bug reports & suggestions to pueschel@imsdd.meb.uni-bonn.de.
  155.  
  156.  
  157. ============================= Archive contents =============================
  158.  
  159. Original  Packed Ratio    Date     Time    Name
  160. -------- ------- ----- --------- --------  -------------
  161.      282     127 54.9% 28-May-96 18:05:36  patch_sc.lib
  162.     3647    1668 54.2% 09-May-96 13:37:50  timezone.doc
  163.      216     202  6.4% 02-Feb-97 15:23:50  DSTCheck
  164.     7524    4377 41.8% 02-Apr-97 19:31:54  ClockDaemon
  165.     5068    2732 46.0% 02-Apr-97 19:31:56  time.lib
  166.     4636    2083 55.0% 02-Apr-97 19:34:20  clockdaemon.readme
  167. -------- ------- ----- --------- --------
  168.    21373   11189 47.6% 03-Apr-97 15:11:32   6 files
  169.